home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / tjgold.zip / GOLDREAD.ME < prev    next >
Text File  |  1995-07-16  |  14KB  |  350 lines
  1.  
  2.  
  3.              ▐▀▀▀▌              ▌    ▐▄▄▄▄▄     ▐
  4.              ▐                  ▌    ▐    █     ▐▀▀
  5.              ▐    ▐▀▀▀▌▐        ▌    ▐    █▐▀▀▀▌▐  ▐▀▀▀ █▀▀▀
  6.              ▐  ▀▌▐   ▌▐    ▐▀▀▀▌    ▐    █▐   ▌▐  ▐▄▄  █▄▄▄
  7.              ▐▄▄▄▌▐▄▄▄▌▐▄▄▄ ▐▄▄▄▌    ▐    █▐▄▄▄▌▐▄ ▐▄▄▄ ▄▄▄█
  8.  
  9.  
  10.      Welcome to Gold. This file contains important, late-breaking
  11.      information about the GOLD toolkit, including updates to the User
  12.      Manual and Reference.
  13.  
  14.  
  15.      TABLE OF CONTENTS
  16.      -----------------
  17.         1) ASP INFORMATION
  18.         2) RELEASE NOTES
  19.         3) ROYALTIES
  20.         4) ADVANTAGES OF REGISTERING GOLD
  21.         5) LIMITED DISTRIBUTION LICENSE
  22.         6) INSTALLING ONLINE HELP IN BP 7.0
  23.         7) NEW PROCEDURES AND FUNCTIONS
  24.         8) GOLD DUST
  25.            ARTICLE 0001 - DATABASE HANDLES
  26.  
  27.  
  28.      1) ASP INFORMATION
  29.      ------------------
  30.  
  31.      ┌────────────────────────────────────────────────────────────────┐
  32.      │                                                                │
  33.      │                 ASP Ombudsman Information                      │
  34.      │                                                                │
  35.      │  TechnoJock Software, Inc. is a member of the Association of   │
  36.      │  Shareware Professionals (ASP). ASP wants to make sure that    │
  37.      │  the shareware principle works for you. If you are unable      │
  38.      │  to resolve a shareware-related problem with an ASP member     │
  39.      │  by contacting the member directly, ASP may be able to help.   │
  40.      │  The ASP ombudsman can help you resolve a dispute or problem   │
  41.      │  with an ASP member, but does not provide technical support    │
  42.      │  for members' products. Please write to the ASP Ombudsman at:  │
  43.      │     ASP Ombudsman                  _______                     │
  44.      │     545 Grover Road           ____|__     |                (R) │
  45.      │     Muskegon, MI           --|       |    |------------------- │
  46.      │        49442-9427 (USA)      |   ____|__  |  Association of    │
  47.      │  or send a Compuserve        |  |       |_|  Shareware         │
  48.      │  message via CompuServe      |__|   o   |    Professionals     │
  49.      │  mail to 70475,1071, or    -----|   |   |--------------------- │
  50.      │  a FAX to 616-788-2765.         |___|___|    MEMBER            │
  51.      │                                                                │
  52.      └────────────────────────────────────────────────────────────────┘
  53.  
  54.     2) RELEASE NOTES
  55.     ----------------
  56.     Gold 1.01  -  Modified numerous units to make code compatible
  57.                   with Turbo Pascal version 6.0
  58.  
  59.     3) ROYALTIES
  60.     ------------
  61.  
  62.      The following text is extracted from the User's Guide, and only
  63.      applies to the registered version:
  64.  
  65.               "Many Gold users develop commercial programs specifically
  66.                to sell for profit. TJ Software, Inc., neither expects
  67.                nor requires a royalty fee on such programs. The major
  68.                restriction is that you may not develop a program that is
  69.                itself a toolkit. In addition, neither the toolkit source
  70.                code nor the compiled units may be distributed or sold as
  71.                part of another product. If you have not registered your
  72.                copy of Gold, you may not develop programs for sale or
  73.                distribution. Refer to the license agreement at the front
  74.                of this manual for our definitive statement on royalties
  75.                and warranties."
  76.  
  77.      Users of the Shareware version of the product may NOT distribute
  78.      any executable files created with GOLD. If you want to create EXE's
  79.      with GOLD for sale or for any form of distribution, you must register
  80.      your copy of GOLD.
  81.  
  82.  
  83.      4) What's the advantage of registering TTTGOLD?
  84.      -----------------------------------------------
  85.  
  86.      Gold is distributed as a Shareware product. When you register
  87.      your copy of the program, you not only get the latest version
  88.      of the toolkit, you also receive the following bonus features:
  89.  
  90.      Books        You get two professionally bound and typeset manuals!
  91.  
  92.      Desktop      The desktop unit allows you to easily create desktop
  93.                   applications with pulldown menus, status bar, etc.
  94.                   Run DEMOVIEW.EXE to see a slick desktop in action.
  95.  
  96.      Calculator   Add a fully functional calculator to your apps with
  97.                   a couple of lines of code. Run DEMOCALC.EXE to see
  98.                   the calculator in action.
  99.  
  100.      INI Unit     This unit makes it a snap to add Windows-style INI
  101.                   file support to your programs.
  102.  
  103.      Online Help  The entire function reference as a BP7 help file.
  104.  
  105.      And, of course, you will be a bonafide owner of GOLD and will be
  106.      able to continue to use the product beyond the 30 day evaluation
  107.      period, and you will be able to distribute EXEs built using GOLD
  108.      without paying royalties.
  109.  
  110.  
  111.      5) LIMITED DISTRIBUTION LICENSE
  112.      -------------------------------
  113.  
  114.      Permission is granted to any individual or business to distribute
  115.      this Shareware version of GOLD, provided they convey a complete and
  116.      unaltered copy of the entire package, and provided they claim no
  117.      ownership of these products.
  118.  
  119.      TechnoJock Software, Inc. may revoke any permissions granted here,
  120.      by notifying you in writing.
  121.  
  122.  
  123.  
  124.         ▐▀▀▀▌      ▐                   ▐   ▌     ▐
  125.         ▐   ▌      ▐                   ▐   ▌     ▐
  126.         ▐   ▌▐▀▀▀▌ ▐ ▐ ▐▀▀▀▌ ▐▀▀▀      ▐▀▀▀▌▐▀▀▀ ▐ ▐ ▀▀█
  127.         ▐   ▌▐   ▌ ▐ ▐ ▐   ▌ ▐▄▄       ▐   ▌▐▄▄  ▐ ▐   █
  128.         ▐▄▄▄▌▐   ▌ ▐ ▐ ▐   ▌ ▐▄▄▄      ▐   ▌▐▄▄▄ ▐ ▐▄▄▄█
  129.                                                    ▐
  130.                                                    ▐
  131.  
  132.      6) INSTALLING ONLINE HELP IN BP 7.0
  133.      -----------------------------------
  134.  
  135.      We have included a superb feature for users of Borland Pascal 7.0
  136.      (or later), an online help facility detailing all the procedures and
  137.      functions for GOLD. If you installed GOLD and checked the online
  138.      help selection, the TTTGOLD.HLP file will have been transferred to
  139.      your system.
  140.  
  141.      Take the following steps to integrate GOLD's on-line help with the
  142.      Borland IDE:
  143.  
  144.      1. Move the compiled help file, TTTGOLD.TPH, to the same directory
  145.         where BP.EXE is located, this is typically \BP\BIN.
  146.  
  147.      2. Execute Borland Pascal.
  148.  
  149.      3. Select Help Files from the IDE's main menu -- the Help options
  150.         will be displayed. From the file selection dialog select
  151.         TTTGOLD.TPH and press OK.
  152.  
  153.       The online help will now be integrated with BP's own help.
  154.  
  155.       Note: Your specific configuration may affect your ability to load and
  156.       use TTTGOLD.TPH. The GOLD Online Help contains extensive information
  157.       on over 700 pascal routines designed to speed up your development time.
  158.       As you attempt to install TTTGOLD.TPH, you may receive a message
  159.       indicating that the help index is too large. To resolve this, return
  160.       to the HELP FILES menu choice and deselect some of the help files
  161.       that you may not need. Borland has included several help features
  162.       that you may not use on a regular basis.
  163.  
  164.       Be sure to save these options so that the help file will load each
  165.       time you use the environment.
  166.  
  167.  
  168.            ▐█    ▌                 ▐ ▀▀█
  169.            ▐ █   ▌                 ▐   █
  170.            ▐  █  ▌ ▐▀▀▀ ▐  ▌ ▌     ▐▄▄▄█ ▐▄▄ ▐▀▀▀▌▐▀▀▀ █▀▀▀
  171.            ▐   █ ▌ ▐▄▄  ▐  ▌ ▌     ▐     ▐   ▐   ▌▐    █▄▄▄
  172.            ▐    █▌ ▐▄▄▄ ▐▄▄▌▄▌     ▐     ▐   ▐▄▄▄▌▐▄▄▄ ▄▄▄█
  173.  
  174.  
  175.  
  176.       7) NEW PROCEDURES AND FUNCTIONS
  177.       --------------------------------
  178.  
  179.       Below are some additional procedures and functions that were added to
  180.       GOLD after the documentation went to press. Note that these routines
  181.       are included in the unabridged on-line help.
  182.  
  183.       ScrollForceCase                                 (GOLDIO2)
  184.       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  185.  
  186.       Purpose:  Controls automatic case adjustments in scrolling string
  187.                 fields.
  188.  
  189.       Syntax:   ScrollForceCase(FieldID:byte; FCase: gCase);
  190.  
  191.       Remarks:  Field ID is the number of the scroll field whose case
  192.                 adjustment will be set. FCase is a member of the enumerated
  193.                 type gVase and may have one of the following values:
  194.                 Upper, Lower, Proper and Leave.
  195.  
  196.       See Also: ScrollField
  197.  
  198.       Example:
  199.  
  200.                 ScrollForceCase(11,Proper);
  201.  
  202.       *******
  203.  
  204.       SetDefaultButton
  205.       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀                                 (GOLDIO)
  206.  
  207.       Purpose:  Assigns a new default button to the current I/O form.
  208.  
  209.       Syntax:   SetDefaultButton(FieldID:byte);
  210.  
  211.       Remarks:  FieldID is the number of the button field that will be
  212.                 assigned the default button status. Pass a FieldID value
  213.                 of zero (the number 0) when you do not want a default
  214.                 button. No validation checks are performed, so be sure
  215.                 to pass the FieldID of a button field. This procedure is
  216.                 designed for use in a hook when changing the identity of
  217.                 the default button; use ButtonDefaultField to assign the
  218.                 default button when defining a form.
  219.  
  220.       See Also: ButtonDefaultField
  221.  
  222.       Example:
  223.  
  224.                 SetDefaultButton(4);
  225.  
  226.  
  227.       *******
  228.  
  229.       MemoReAssignSLL                                   (GOLDMEMO)
  230.       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  231.  
  232.       Purpose:  Advises Gold that the contents of an SLL has been updated
  233.                 and that the MemoCfg variable needs to reflect the changes.
  234.  
  235.       Syntax:   MemoReAssignSLL(var MemoDetails: MemoCfg;
  236.                                 var MemoSource: SingleLL);
  237.  
  238.       Remarks:  The first parameter is the memo configuration which will
  239.                 be used to display the memo. The second parameter is the
  240.                 SLL variable that was originally assigned with the
  241.                 MemoAssignSLL function. Use this procedure when the
  242.                 contents of the SLL have been updated on the fly (i.e. not
  243.                 by editing the memo manually).
  244.  
  245.       See Also: MemoAssignSLL
  246.  
  247.       Example:
  248.  
  249.                 procedure DatabaseToScreen(RecNo:longint);
  250.                 {}
  251.                 begin
  252.                    with EmpRec do
  253.                    begin
  254.                       EmpName := DbGetFldString(RecNo,1);
  255.                       Dept := DbGetFldString(RecNo,2);
  256.                       if DbGetMemoRecNum(RecNo,3) = 0 then  {no memo}
  257.                       begin
  258.                          SLLSetActiveList(JobDesc);
  259.                          SLLEmptyList;
  260.                       end
  261.                       else
  262.                          DbGetFldMemo(RecNo,3,MemoFldVar);
  263.                       MemoReAssignSLL(MemoFldVar,JobDesc);
  264.                    end;
  265.                 end; { DatabaseToScreen }
  266.  
  267.    *********
  268.  
  269.  
  270.            ▐▀▀▀▌              ▌    ▐▀▀▀▀▄            ▐
  271.            ▐                  ▌    ▐    █            ▐▀▀
  272.            ▐    ▐▀▀▀▌▐        ▌    ▐    █ ▐   ▌ █▀▀▀ ▐
  273.            ▐  ▀▌▐   ▌▐    ▐▀▀▀▌    ▐    █ ▐   ▌ █▄▄▄ ▐
  274.            ▐▄▄▄▌▐▄▄▄▌▐▄▄▄ ▐▄▄▄▌    ▐▄▄▄▄▀ ▐▄▄▄▌ ▄▄▄█ ▐▄
  275.  
  276.  
  277.       8) GOLD DUST
  278.       ------------
  279.  
  280.       If there is a particular aspect of Gold which is not clearly understood
  281.       by the users, we will release a brief "white paper" explaining the
  282.       subject more clearly. These papers are known as "Gold Dust" and they
  283.       will be available online as well as in this file.
  284.  
  285.       At present we only have one Gold Dust paper (below) which discusses the
  286.       notion of database handles.
  287.  
  288.       ┌────────────────────────────────────────────────────────────────────────┐
  289.       │ ARTICLE 0001   Assigning and using Handles with a database.            │
  290.       └────────────────────────────────────────────────────────────────────────┘
  291.  
  292.       The entire framework of database management in GOLD is based on the
  293.       "database handle". When opening a database using DbOpenDataSet, which
  294.       is the recommended process, it is important to assign this open
  295.       process to a handle. For example,
  296.  
  297.               var Handle: integer;
  298.  
  299.               begin
  300.                  Handle := DbOpenDataSet(<DataFileName>);
  301.                  if Handle <> 0 then
  302.                     DoSomething;
  303.                  DbCloseDataBase(Handle);
  304.               end.
  305.  
  306.       This way it is possible to open multiple databases and change focus
  307.       from one database to another. That is, all the database functions
  308.       operate on the database with focus. To change focus, use
  309.       DbSetActiveDataBase and pass the handle of the database to which you
  310.       want to give focus.
  311.  
  312.       A zero returned from opening a dataset indicates that the open was
  313.       not successful. Check the returned value of LastDBError to find out
  314.       why the failure occurred.
  315.  
  316.       It is not recommended to open a dataset as follows:
  317.  
  318.           if DbOpenDataSet(<DataFileName>) <> 0 then
  319.              DoSomethingElse;
  320.  
  321.       This example does not make the proper assignment to a handle,
  322.       leaving no way to change focus or close the database.
  323.  
  324.       If your application requires that you open more than one database
  325.       at a time, the variable name "Handle" would not be a good variable to
  326.       assign. Database1, Database2, etc. would be preferable names, or
  327.       perhaps the handle could be named after the specific database,
  328.       VeggieFile, MeatFile, BeverageFile. Use your own set of rules here.
  329.       Just remember, each database gets its own handle, whatever naming
  330.       convention you use.
  331.  
  332.       You may close a specific data file by passing its handle to the close
  333.       process, DbCloseDatabase.
  334.  
  335.               var Handle: integer;
  336.  
  337.               begin
  338.                  Handle := DbOpenDataSet(<DataFileName>);
  339.                  if Handle <> 0 then
  340.                     DoSomething;
  341.                  DbCloseDataBase(Handle);
  342.               end.
  343.  
  344.       DbCloseAllDatabases closes all currently open databases and so
  345.       requires no parameters be passed. This also disposes of all handles.
  346.  
  347.       END OF ARTICLE 0001
  348.  
  349.  
  350.